
// 包v3alarm管理etcd中的健康状态警报。
package v3alarm

import (
	"sync"

	pb "go.etcd.io/etcd/api/v3/etcdserverpb"
	"go.etcd.io/etcd/client/pkg/v3/types"
	"go.etcd.io/etcd/server/v3/storage/backend"

	"go.uber.org/zap"
)

type BackendGetter interface {
	Backend() backend.Backend
}

type AlarmBackend interface {
	CreateAlarmBucket()
	MustPutAlarm(member *pb.AlarmMember)
	MustDeleteAlarm(alarm *pb.AlarmMember)
	GetAllAlarms() ([]*pb.AlarmMember, error)
	ForceCommit()
}

type alarmSet map[types.ID]*pb.AlarmMember

// AlarmStore将报警持久化到后端。
type AlarmStore struct {
	lg    *zap.Logger
	mu    sync.Mutex
	// 在该 map 字段中记录了每种 AlarmType
	// 对应的 AlarrnMember 实例。 AlarmType 现在只有 AlarmType_NONE 和 AlarmType_ NOSPACE 两种类型。
	// alarmSet 类型实际上是 map[types.ID]*pb.AlarrnMember 类型，其
	// 中记录了节点 ID 与 AlarrnMember 之间的映射关系。
	types map[pb.AlarmType]alarmSet

	be AlarmBackend
}

func NewAlarmStore(lg *zap.Logger, be AlarmBackend) (*AlarmStore, error) {
	if lg == nil {
		lg = zap.NewNop()
	}
	ret := &AlarmStore{lg: lg, types: make(map[pb.AlarmType]alarmSet), be: be}
	err := ret.restore()
	return ret, err
}

// AlarmStore.Activate （）方法负责新建 AlarmMember 实例，并将其记录到 AlarmStore.types 字段和底层存储中
func (a *AlarmStore) Activate(id types.ID, at pb.AlarmType) *pb.AlarmMember {
	a.mu.Lock()
	defer a.mu.Unlock()

	newAlarm := &pb.AlarmMember{MemberID: uint64(id), Alarm: at}	// 新建 AlarmMember 实例
	if m := a.addToMap(newAlarm); m != newAlarm {	// 将 AlarmMember 添加到 types 字段
		return m
	}

	a.be.MustPutAlarm(newAlarm)
	return newAlarm
}

// AlarmStore.Deactivate（）方法负责从 types 字段和底层存储中删除指定的 AlarmMember 实例，
func (a *AlarmStore) Deactivate(id types.ID, at pb.AlarmType) *pb.AlarmMember {
	a.mu.Lock()
	defer a.mu.Unlock()

	t := a.types[at]	// 根据 AlarmType 类型查找 alarmSet
	if t == nil {
		t = make(alarmSet)
		a.types[at] = t
	}
	m := t[id]	// 根据id 查找 AlarmMember 实例
	if m == nil {
		return nil
	}

	delete(t, id)	// 从 types 字段中删除指定的 AlarmMember 实例

	a.be.MustDeleteAlarm(m)
	return m
}

// AlarmStore. Get（） 方法 ，如 果 传入的 参数为 AlarmType_NONE ， 则返回 该
// AlarmStore 实例中的全部 AlarmMember 实例
func (a *AlarmStore) Get(at pb.AlarmType) (ret []*pb.AlarmMember) {
	a.mu.Lock()
	defer a.mu.Unlock()
	if at == pb.AlarmType_NONE {	// 针对 AlarmType_NONE 类型的 AlarmType 处理
		for _, t := range a.types {	// 遍历 types 字段中全部的 AlarmMember 返回
			for _, m := range t {
				ret = append(ret, m)
			}
		}
		return ret
	}
	for _, m := range a.types[at] {	// 只返回指定类型的 Alar时1ember 实例
		ret = append(ret, m)
	}
	return ret
}

func (a *AlarmStore) restore() error {
	a.be.CreateAlarmBucket()
	ms, err := a.be.GetAllAlarms()
	if err != nil {
		return err
	}
	for _, m := range ms {
		a.addToMap(m)
	}
	a.be.ForceCommit()
	return err
}

func (a *AlarmStore) addToMap(newAlarm *pb.AlarmMember) *pb.AlarmMember {
	t := a.types[newAlarm.Alarm]
	if t == nil {
		t = make(alarmSet)
		a.types[newAlarm.Alarm] = t
	}
	m := t[types.ID(newAlarm.MemberID)]
	if m != nil {
		return m
	}
	t[types.ID(newAlarm.MemberID)] = newAlarm
	return newAlarm
}
